Gửi yêu cầu HEAD (http.head)
Khai báo
mã trạng thái HTTP, văn bản JSON của header phản hồi = http.head(URL [, thời gian chờ tính bằng giây, header yêu cầu, không escape URL ])
Khai báo (đối số có tên)
Hỗ trợ từ phiên bản 20250625; các tùy chọn tiến trình được hỗ trợ từ phiên bản 20260402
mã trạng thái HTTP, văn bản JSON của header phản hồi = http.head{
url = URL;
timeout = thời gian chờ tính bằng giây;
headers = header yêu cầu;
params = tham số query;
progress = hàm gọi lại tiến độ;
progress_interval_ms = khoảng thời gian giữa các lần gọi lại tiến độ tính bằng mili giây;
}
Tham số
- URL
Kiểu chuỗi. URL yêu cầu. Hàm mặc định escape URL; xemkhông escape URLnếu không muốn xử lý này. - thời gian chờ tính bằng giây
Kiểu số, không bắt buộc. Thời gian chờ tính bằng giây. Mặc định: 10. - header yêu cầu
Kiểu bảng, không bắt buộc. Header yêu cầu có dạng{ field1 = value1, ... }. Mặc định:{}. - tham số query
Kiểu bảng, không bắt buộc. Tham số chuỗi truy vấn có dạng{ field1 = value1, ... }. Mặc định:{}. - hàm gọi lại tiến độ
Kiểu hàm, không bắt buộc. Hỗ trợ từ phiên bản 20260402. Được gọi khi tiến trình yêu cầu thay đổi; đối số đầu tiên là thông tin tiến trình hiện tại. - khoảng thời gian giữa các lần gọi lại tiến độ tính bằng mili giây
Kiểu số nguyên, không bắt buộc. Hỗ trợ từ phiên bản 20260402. Khoảng thời gian giữa các lần gọi lại tiến độ, tính bằng mili giây. - không escape URL
Kiểu boolean, không bắt buộc. true = không escape URL. Mặc định: false.
Để tự escape, hãy xem mô-đunlcurl, easy:escape và easy:unescape.
Giá trị trả về
- mã trạng thái HTTP
Kiểu số nguyên. Mã trạng thái HTTP; trả về -1 khi hết thời gian chờ. - văn bản JSON của header phản hồi
Kiểu chuỗi hoặc nil. Header phản hồi ở định dạng JSON; trả về nil khi hết thời gian chờ.
Mô tả
Dùng phương thức HEAD của HTTP/1.1 để lấy header phản hồi.
HEAD thường trả về cùng header với GET nhưng không có nội dung phản hồi.
Hàm này có thể nhường quyền thực thi; các luồng khác có thể được chạy trước khi hàm trả về.
Bảng info được truyền cho hàm gọi lại tiến độ có cấu trúc như sau:
{
count_of_bytes_sent = bytes_sent;
count_of_bytes_expected_to_send = bytes_expected_to_send;
count_of_bytes_received = bytes_received;
count_of_bytes_expected_to_receive = bytes_expected_to_receive;
}
Ví dụ
local c, h = http.head("https://www.xxtouch.app/测试文本.txt")
if c==200 then
sys.alert(h)
end
Lưu ý: Ví dụ trên sử dụng hàm ngoài chương này sys.alert.